home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / BASIC / 3940.ZIP / PWEZ.ZIP / UPDATE.DOC < prev    next >
Text File  |  1993-06-01  |  19KB  |  361 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.            Update Information  ( Versions 5.00 / 5.10 / 6.00 / 6.10 )
  7.  
  8.           The following routines were changed or added in version 6.00.
  9.           These will require changes in programs written in versions 5.10
  10.           and 5.00. ( *6.10 = refers to version 6.10 only )
  11.  
  12.           Use the new DECLARE.INC file as an include file in all modules
  13.           in programs written in earlier versions to assure compatibility.
  14.  
  15.           - Text modes 80 x 25, 80 x 43, and 80 x 50 are supported in
  16.             Ver. 6.00.  Text mode 40 x 25 is no longer supported.
  17.  
  18.           - Event trapping is permissible in Ver 6.00.  See WIND_REZ.DOC
  19.             for details.
  20.  
  21.           - (*6.10) All previous versions used BASIC's floating point math
  22.             routines.  This generated over 11,000 bytes of extra program
  23.             code for even the smallest of programs.  All reference to any
  24.             of BASIC's arithmetic operations or BASIC's statements using
  25.             BASIC's floating point math routines has now been removed from
  26.             WINDOWS R-E-Z.  This allows executable's to be over 11,000 bytes
  27.             smaller provided THE APPLICATION PROGRAM DOES NOT USE ANY OF
  28.             BASIC's ARITHMETIC OPERATORS ( EX: ^ / ) OR STATEMENTS
  29.             ( EX: VAL, SOUND ).
  30.  
  31.  
  32.             Routine       Changes
  33.           -------       -------------------------------------------------
  34.           PULLDOWN      May now be optionally exited if the MOUSE is
  35.           (*6.10)       pressed outside of the menubar or active pulldown
  36.                         window.
  37.                         May now be used in a "loop" mode waiting for the
  38.                         ALT key to be pressed.  The ability to use as in
  39.                         previous versions has been retained.
  40.  
  41.           KEYMOUSE%     This function has been replaced by individual
  42.                         keyboard ( GETAKEY% ) and mouse functions.
  43.  
  44.           SETSCRL       This routine has been eliminated.  The scroll
  45.                         arrow on the right border scroll windows has been
  46.                         replaced with scroll bars set by routine SCRLWIND.
  47.                         The argument for the "TAG" designator has been
  48.                         moved to routine B4SCRL.  The argument for no-high
  49.                         intensity characters has been moved to routine
  50.                         SETWIND as it now affects several routines,
  51.  
  52.           B4SCRL        Two arguments have been added to this routine.
  53.                         One represents the color of the "TAG" designator
  54.                         for mark scroll windows.  The other allows scroll
  55.                         windows to be re-entered without refreshing same.
  56.  
  57.           SCRLWIND      Two arguments have been added.  One allows
  58.                         vertical and horizontal scroll bars.  The other
  59.                         allows < OK > and < CANCEL > buttons.
  60.  
  61.           INPTINIT      One argument, EXIT$, has been moved to a new
  62.                         routine, B4INPT.  Three new arguments allow input
  63.                         fields in routines INPTWIND and MULTINPT to be
  64.                         entered with the cursor in position one or after
  65.                         the last character in the field.  The second new
  66.                         argument allows a choice to blank an input field
  67.                         when the first valid character and display the
  68.                         character or to add the character to existing
  69.                         text in the field.  The third argument allows the
  70.                         default sound to be generated when an invalid
  71.                         character is pressed.
  72.  
  73.           B4INPT        NEW.  This routine sets "exit keys" and restrict
  74.                         characters for a subsequent call to INPTWIND.
  75.  
  76.           INPTWIND      Separate arguments now designate field and window
  77.                         colors.  An argument has been added which allows
  78.                         the use of < OK > and < CANCEL > buttons.  Real
  79.                         numbers have been included as a field choice. The
  80.                         argument for routine RESTRICT$ has been moved to
  81.                         routine B4INPT.
  82.  
  83.           SETINPT       This routine is no longer used to make individual
  84.                         fields for routine MULTINPT.  It is now used to
  85.                         set a MULTINPT screen number, display length,
  86.                         "exit keys" and field "hot character" colors.  As
  87.                         all screens must be 80 column width the argument
  88.                         for display width ( COLWID% ) has been eliminated.
  89.  
  90.           MAKEFIELD     NEW.  This routine makes individual field for
  91.                         routine MULTINPT.  Real number fields, "mouse only
  92.                         selectable", and button fields now are available.
  93.                         Fields may have different active, inactive, and
  94.                         "mouse active" colors.  Fields may have "exit-to"
  95.                         characters, and a differently colored which may be
  96.                         a different color than the other characters.
  97.                         Fields are either AUTO-EXIT or not AUTO-EXIT.
  98.                         The AUTO-EXIT ON CHANGE field has been eliminated.
  99.  
  100.           UPDATEFIELD   NEW.  This routine can be used to update an
  101.                         individual field.
  102.  
  103.           MULTINPT      The argument representing the "from field", on
  104.                         exit, always point to the "from field" regardless
  105.                         of the exit circumstances.  A new argument has
  106.                         been added to designate exit via a "mouse only
  107.                         selectable" field.  AUTO-EXIT ON CHANGE fields
  108.                         are no longer supported.
  109.  
  110.           EXEPATH$      NEW.  Returns the path of the executable program.
  111.           (*6.10)       Only useful after a program is compiled and linked
  112.                         into an "executable".
  113.  
  114.           TWOPOWEROF&   NEW.  Returns a long integer representing two
  115.           (*6.10)       to the "nth" power. Used to replace BASIC's ^
  116.                         operator with an mantissa of two.  This prevents
  117.                         the inclusion of BASIC's floating point math
  118.                         routines in a program.
  119.  
  120.           WVAL&         NEW.  Returns a long integer representing the
  121.           (*6.10)       value of a numeric string.  Used to replace
  122.                         BASIC's  VAL function. This prevents the inclusion
  123.                         of BASIC's floating point math routines in a
  124.                         program.
  125.  
  126.           WTIMER&       NEW.  Returns a long integer holding the value of
  127.           (*6.10)       the systems 1/18th second timer.  Can be used to
  128.                         simulate BASIC's SLEEP statement for periods less
  129.                         than a second.
  130.  
  131.           PRINTMENUBAR  NEW.  Prints the pulldown menubar.  Useful if the
  132.           (*6.10)       ALT key will be used to enter routine PULLDOWN.
  133.                         SEE ROUTINE PULLDOWN.
  134.  
  135.           SCROLLPRINT   NEW.  Allows a subsequent call to routine SCRLWIND
  136.           (*6.10)       to print the scroll window's present selection
  137.                         at any screen location.
  138.  
  139.           GETAKEY%      NEW.  Returns a value for the key pressed or zero
  140.                         if no key has been pressed.  Replaces KEYMOUSE%.
  141.  
  142.           CLEARKB       NEW.  Clears the type ahead keyboard buffer.
  143.  
  144.           CHOICEWIND%   NEW.  Displays a text filled window with up to
  145.                         ten choices.
  146.  
  147.           CHOICEBAR%    NEW.  Displays a choice bar with up to ten
  148.                         choices.
  149.  
  150.           GETANS        A new argument allows for a different field and
  151.                         window  colors.
  152.  
  153.           BOXW          NEW.  Draws a box in the active window.
  154.  
  155.           PRINTWHOT     NEW.  Prints text with a "hot character" in the
  156.                         active window.
  157.  
  158.           MOUSEINMULT%  NEW.  Returns a value if the mouse cursor occupies
  159.                         a field for a specified MULTINPT screen.
  160.  
  161.           MOUSEINWIND%  NEW.  Returns a value if the mouse cursor is in a
  162.                         specified window.
  163.              *6.10 --   Earlier releases of version 6.00 did not allow the
  164.                         use of this function in window number zero. This
  165.                         is permitted in version 6.10.
  166.  
  167.           LBUTTON%      NEW.  Returns a value if the left mouse button is
  168.                         pressed.
  169.  
  170.           RBUTTON%      NEW.  Returns a value if the right mouse button is
  171.                         pressed.
  172.  
  173.           MOUSEROW%     NEW.  Returns the mouse cursor display row.
  174.  
  175.           MOUSECOL%     NEW.  Returns the mouse cursor display column.
  176.  
  177.           MOUSELIMIT    NEW.  Sets limits for mouse cursor movement.
  178.  
  179.           MOUSEPOS      NEW.  Returns the mouse cursor row and column
  180.                         position.
  181.  
  182.           MOUSEON%      Now a function which attempts to turn the mouse on
  183.                         and returns a value if successful.
  184.  
  185.           MOUSEHIDE     NEW.  Hides the mouse cursor.
  186.  
  187.           MOUSESHOW     NEW.  Displays a previously hidden mouse cursor.
  188.  
  189.           GETDISK%      Now a function which returns the default drive.
  190.                         Formally a sub-routine.
  191.  
  192.           FINDPATH$     Now a function which returns the default path.
  193.                         Formally a sub-routine.
  194.            *6.10 ---    Changed to always have the path returned with a
  195.                         "\" as the last character in the path.
  196.                         ( EX: C:\  C:\DOS\. )  This provides consistency
  197.                         with function EXEPATH$ which is new to Ver. 6.10.
  198.  
  199.  
  200.           PEEKASM&      NEW.  Returns a value in a designated memory
  201.                         location.
  202.  
  203.           DISPLAYROWS%  NEW.  Return the number of active display rows.
  204.  
  205.           GETCUR&       NEW.  Returns a value representing the system
  206.                         cursor position and size.
  207.  
  208.           CUROFF        NEW.  Turns the system cursor off.
  209.  
  210.           SETCUR        NEW.  Restores the system cursor size and position.
  211.  
  212.  
  213.           ---------------------------------------------------------------
  214.           The following routines were changed or added in version 5.00 and
  215.           version 5.10.  These will require changes in programs written in
  216.           version 4.20. ( *5.10 = Applies to changes in version 5.10 only.)
  217.  
  218.           NOTE: One of the major changes involves the active pulldown
  219.           and active input window concept.  For compatibility with
  220.           previous versions of WINDOWS R-E-Z call new routine RSTRPULL
  221.           on exit from routine PULLDOWN and call new routine RSTRINPT
  222.           on exit from routine INPTWIND.  Calls to these routines
  223.           deactivate the active pulldown and input windows therefore
  224.           simulating performance in earlier versions.  The increased
  225.           flexibility provided by active pulldown and input windows,
  226.           however, is eliminated.
  227.  
  228.  
  229.           Routine       Changes
  230.           --------      -------------------------------------------------
  231.           SETWIND       Several arguments have been eliminated and are
  232.                         now defined by routine INPTINIT.
  233.              *5.10 --   Several arguments have been eliminated and are
  234.                         now defined by routine SETSCRL.
  235.  
  236.           INPTINIT      NEW. This routine sets the date format and the
  237.                         decimal designator.  It also defines the "exit
  238.                         keys" for routine INPTWIND.  THIS ROUTINE MUST BE
  239.                         CALLED ONCE BEFORE USING THE INPUT ROUTINES.
  240.  
  241.           SETPULL       The format of the array holding the data for
  242.                         the pulldown windows has changed.
  243.                         The argument defining the menubar has been
  244.                         eliminated.
  245.  
  246.           PULLDOWN      A new argument, an array holding the info-line
  247.                         data, has been added.
  248.                         The pulldown window on exit is now considered
  249.                         the active pulldown window.  It remains displayed
  250.                         on exit.  The active pulldown window may be re-
  251.                         entered as long as it remains active.
  252.                         A new argument suppressing exit on ESC has been
  253.                         added. ( replaced in version 5.10 ).
  254.              *5.10 --   A new argument permits definable "exit keys".
  255.                         It replaces the argument added in version 5.00
  256.                         which suppressed exit on the ESC key.
  257.              *5.10 --   A new argument which returns the "exit key" has
  258.                         been added.
  259.  
  260.           RSTRPULL      NEW.  This routine can be used to restore the
  261.                         display area under, and deactivate the active
  262.                         pulldown window.
  263.  
  264.           SETSCRL       NEW.  Turns the position arrow on the right border
  265.           (*5.10)       of scroll windows "ON" or "OFF".  Determines how
  266.                         pulldown and scroll windows display high intensity
  267.                         characters.  Both of these features were previously
  268.                         included in routine SETWIND.  This routine also sets
  269.                         the color for the arrow designating "marked"
  270.                         entries in marked scroll windows.  If this routine
  271.                         is not called the position arrow defaults to "OFF".
  272.                         High intensity characters are displayed normally
  273.                         and the arrow designating marked entries assumes the
  274.                         same color as the text.
  275.  
  276.           B4SCRL        NEW.  This new routine permits definable "exit
  277.           (*5.10)       keys" for a single subsequent call to SCRLWIND.  It
  278.                         also allows marked ( tagged ) entries to be set for
  279.                         a single subsequent call to routine SCRLWIND.
  280.  
  281.           SCRLWIND      A new argument, an array holding the info-line
  282.                         data, has been added.
  283.                         A new argument defining the title for virtual
  284.                         scroll windows has been added.
  285.                         A new argument which represents the key pressed
  286.                         to exit the routine has been added.  This argument
  287.                         may be used to determine the key which caused
  288.                         SCRLWIND to exit.
  289.                         "Virtual" scroll windows are a new feature,
  290.                         The argument defining the "key character" color
  291.                         has the added responsibility of allowing virtual
  292.                         scroll windows.
  293.                         "List" scroll windows are a new feature.
  294.              *5.10  --  A new argument sets the row to be occupied by the
  295.                         scroll bar on entry and returns the row occupied by
  296.                         the scroll bar on exit.
  297.              *5.10  --  A new argument sets the column position for
  298.                         characters on entry and returns same. ( for virtual
  299.                         scroll windows )
  300.              *5.10  --  A new feature allowing "extendable" scroll windows
  301.                         has been added.  Extendable scroll windows allow
  302.                         scrolling through random access, ISAM, BTRIEVE, or
  303.                         other large data files.
  304.  
  305.           INPTWIND      The values for the argument which represents the
  306.                         key pressed to exit the routine have changed to
  307.                         provide consistency with other routines.
  308.                         On exit the input window remains displayed and
  309.                         becomes the active input window.  The active
  310.                         input window may be re-entered as long as it
  311.                         remains active.
  312.                         Several exit keys, as defined in new routine
  313.                         INPTINIT may now exit INPTWIND.
  314.  
  315.           RSTRINPT      NEW. This routine is used to restore the display
  316.                         area occupied by the active input window
  317.                         generated by routine INPTWIND.  This routine
  318.                         also deactivates the active input window.
  319.  
  320.           MULTINPT      All possibilities for exit are resolved by one
  321.                         argument.  Previous versions used argument EXIT$.
  322.                         Using this argument is no longer necessary or
  323.                         possible.  Argument RKEY% now has this respons-
  324.                         ibility. It provides consistency with routines
  325.                         INPTWIND and SCRLWIND for the values representing
  326.                         the "exit keys."
  327.  
  328.           FINDPATH      The path found is returned in the DOS format.
  329.  
  330.           FINDDIR       The path for the directory search must be in
  331.                         the DOS format.
  332.  
  333.           GETANS        This routine may now display the character
  334.           (*5.10)       representing the key pressed and wait for ENTER to
  335.                         finalize the selection.  It may be used as in
  336.                         previous versions also.
  337.                         The argument representing the key pressed on exit
  338.                         is now used to determine the mode of operation on
  339.                         entry.  To use as in previous versions this
  340.                         argument must = "" on entry.
  341.  
  342.           INFOLINE      NEW. This routine sets the coordinates for, and
  343.                         saves the display area to be used by the info-
  344.                         line.  The info-line is new in version 5.00.  It
  345.                         is used to display instructions, prompts or
  346.                         information any place on the display.
  347.  
  348.           PRINTINFO     NEW. This routine prints text in the info-line
  349.                         defined in a previous call to routine INFOLINE.
  350.  
  351.           INFOFIXED     NEW. This routine defines a fixed string which
  352.                         prints in the info-line for every call to
  353.                         routine PRINTINFO.  The text specified in routine
  354.                         PRINTINFO is appended to the fixed string defined
  355.                         by this routine.
  356.  
  357.           WAVAIL%       NEW. This function can provide window status for
  358.                         all windows including pulldown and input windows.
  359.                         It also provides the status of the pulldown menubar
  360.                         and the info-line.
  361.